home *** CD-ROM | disk | FTP | other *** search
/ iBrowse Update Disc / iBrowse Update Disc.iso / distrib / man / Manuals / Omniclient / 8_AppxB < prev    next >
Text File  |  1998-02-04  |  10KB  |  266 lines

  1. <HTML>
  2. <HEAD>
  3. <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1">
  4. <TITLE>NFS star commands</TITLE>
  5.  
  6. <META NAME="GENERATOR" CONTENT="Internet Assistant for Microsoft Word 2.04z">
  7. </HEAD>
  8. <BODY BGCOLOR="#FFFFFF">
  9. <P>
  10. <A HREF="7_AppxA" ><IMG SRC="pics/PREV.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
  11. <A HREF="Front" ><IMG SRC="pics/FRONT.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
  12. <A HREF="TOC" ><IMG SRC="pics/CONTS.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
  13. <A HREF="index" ><IMG SRC="pics/INDEX.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
  14. <A HREF="9_AppxC" ><IMG SRC="pics/NEXT.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
  15. <H1>Appendix B: NFS star commands</H1>
  16. <HR>
  17. <H2>*<A NAME="Free">Free</A></H2>
  18. <P>
  19. Displays free space on a mount
  20. <H3>Syntax</H3>
  21. <P>
  22. <TT><FONT FACE="Courier">*Free [<I>mountname</I>]</FONT></TT> 
  23. <H3>Parameters</H3>
  24. <P>
  25. <TT><I><FONT /TT>  FACE="Courier">mountname</FONT></I></TT>  is
  26. the name of an NFS mount point
  27. <H3>Use</H3>
  28. <P>
  29. *Free displays your available free space on a mount, the total
  30. free space on that mount, and the size of the mounted filesystem.
  31. If the mounted filesystem is using quotas, *Free shows your free
  32. and used space on it, the quota beneath which you are expected
  33. to remain, and the absolute limit of usage that you cannot exceed.
  34. <P>
  35. If no mountname is given, the current one is used.
  36. <H3>Example</H3>
  37. <P>
  38. <TT><B><FONT /TT>  FACE="Courier">*Free tp1usr</FONT></B></TT> 
  39. <P>
  40. <TT><FONT FACE="Courier">No quota on tp1usr<BR>
  41. Space on filing system:<BR>
  42. Free 69 889K<BR>
  43. Available 33 168K<BR>
  44. Size 367 218K</FONT></TT> 
  45. <P>
  46. <TT><B><FONT /TT>  FACE="Courier">*Free home</FONT></B></TT> 
  47. <P>
  48. <TT><FONT FACE="Courier">Bytes free 9 626K<BR>
  49. Bytes used 374K<BR>
  50. Bytes quota 10 000K<BR>
  51. Bytes limit 12 000K</FONT></TT> 
  52. <H3>Related commands</H3>
  53. <P>
  54. None
  55. <HR>
  56. <H2>*<A NAME="Logon">Logon</A></H2>
  57. <HR>
  58. <P>
  59. Sets the name server to use and/or authenticates a user/password
  60. pair
  61. <H3>Syntax</H3>
  62. <P>
  63. <TT><FONT FACE="Courier">*Logon [-Host <I>hostname</I>] [<I>username</I>[[CR]<I>password</I>]]</FONT></TT> 
  64. <H3>Parameters </H3>
  65. <P>
  66. <TABLE >
  67. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=149><TT><I><FONT /TT>  FACE="Courier">hostname</FONT></I></TT> 
  68. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=419>the host to be used as the name server for this and subsequent name requests
  69. </TD></TR>
  70. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=149><TT><I><FONT /TT>  FACE="Courier">username</FONT></I></TT> 
  71. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=419>the user whose details are to be authenticated on the name server
  72. </TD></TR>
  73. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=149><TT><I><FONT /TT>  FACE="Courier">password</FONT></I></TT> 
  74. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=419>the user's password, which - if omitted - you will be prompted for
  75. </TD></TR>
  76. </TABLE>
  77. <H3>Use</H3>
  78. <P>
  79. *Logon sets the name server to use and/or authenticates a user/password
  80. pair, depending on the parameters passed:
  81. <UL>
  82. <LI>if a hostname is given, then it sets the name server to use
  83. for this and subsequent authentication using *Logon
  84. <LI>if a username and password are given, they are passed to the
  85. current name server for authentication; they are also used to
  86. access any mount points you create in the future
  87. <LI>if no parameters are given, then the current user and name
  88. server are displayed.
  89. </UL>
  90. <H3>Examples </H3>
  91. <P>
  92. <TABLE >
  93. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=208><TT><FONT FACE="Courier">*Logon -Host tp1</FONT></TT> 
  94. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=360>Sets tp1 as the current name server.
  95. </TD></TR>
  96. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=208><TT><FONT FACE="Courier">*Logon mhardy</FONT></TT> 
  97. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=360>Prompts for the password, which is reflected as dashes; authenticates the pair using the current name server (ie tp1); if the password is valid, sets the current user to mhardy.
  98. </TD></TR>
  99. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=208><TT><FONT FACE="Courier">*Logon</FONT></TT> 
  100. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=360>Displays the current user (mhardy) and the current name server (tp1).
  101. </TD></TR>
  102. </TABLE>
  103. <H3>Related commands</H3>
  104. <P>
  105. *Mount
  106. <HR>
  107. <H2><A NAME="Mount">*Mount</A></H2>
  108. <HR>
  109. <P>
  110. Lists or mounts NFS mount points
  111. <H3>Syntax</H3>
  112. <P>
  113. <TT><FONT FACE="Courier">*Mount [-Host <I>hostname</I>] [<I>mountname</I>
  114. [<I>mountpath</I>]]</FONT></TT> 
  115. <H3>Parameters </H3>
  116. <P>
  117. <TABLE >
  118. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=111><TT><I><FONT /TT>  FACE="Courier">hostname</FONT></I></TT> 
  119. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=457>the host to be used as the NFS server for this and subsequent mount requests
  120. </TD></TR>
  121. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=111><TT><I><FONT /TT>  FACE="Courier">mountname</FONT></I></TT> 
  122. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=457>the name by which RISC OS will refer to this mount point
  123. </TD></TR>
  124. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=111><TT><I><FONT /TT>  FACE="Courier">mountpath</FONT></I></TT> 
  125. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=457>the directory on the NFS server which shall act as $ on NFS::mountname
  126. </TD></TR>
  127. </TABLE>
  128. <H3>Use</H3>
  129. <P>
  130. *Mount lists or mounts NFS mount points, depending on the parameters
  131. passed:
  132. <UL>
  133. <LI>if a hostname is given, then it sets the host as the NFS server
  134. to be used for this and any subsequent mount requests; it also
  135. lists all mount points on the host, giving the mount name, mount
  136. path and user name for each mount point
  137. <LI>if a mountname and mountpath are given, then the mountpath
  138. is mounted, using the last user name that was successfully authenticated
  139. with *Logon, and the URD, CSD, PSD and Library are all set to
  140. $ (i.e. the mountpath)
  141. <LI>if no mountpath is given, but a mountname is given for which
  142. a mount already exists, then the URD, CSD, PSD and Library are
  143. all reset to $ for that mount
  144. <LI>if no parameters are given, then all current mount points
  145. are listed, showing the mount name, mount path and user name for
  146. each mount point.
  147. </UL>
  148. <P>
  149. The files accessed via a mount point are always accessed using
  150. the details of the user which was current at the time the *Mount
  151. command was executed.
  152. <H3>Examples </H3>
  153. <P>
  154. <TABLE >
  155. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=246><TT><FONT FACE="Courier">*Mount -Host tp1 tp1usr /usr</FONT></TT> 
  156. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=323>Mounts the directory /usr on the host tp1, giving it the mount name tp1usr.
  157. </TD></TR>
  158. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=246><TT><FONT FACE="Courier">*Mount tp1usr</FONT></TT> 
  159. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=323>Resets the URD, CSD, PSD and Library for the mount named tp1usr to $ on that mount
  160. </TD></TR>
  161. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=246><TT><FONT FACE="Courier">*Mount -Host tp1</FONT></TT> 
  162. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=323>Lists all mount points on tp1.
  163. </TD></TR>
  164. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=246><TT><FONT FACE="Courier">*Mount</FONT></TT> 
  165. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=323>Lists all mount points.
  166. </TD></TR>
  167. </TABLE>
  168. <H3>Related commands</H3>
  169. <P>
  170. *<A HREF="#Logon">Logon</A>
  171. <HR>
  172. <H2>*<A NAME="NFS">NFS</A></H2>
  173. <HR>
  174. <P>
  175. Selects NFS as the <A NAME="current">current</A> filing system
  176. <H3>Syntax</H3>
  177. <P>
  178. <TT><FONT FACE="Courier">*NFS</FONT></TT> 
  179. <H3>Use</H3>
  180. <P>
  181. *NFS selects NFS as the filing system for subsequent operations.
  182. Remember that it is not necessary to switch filing systems if
  183. you use the full pathnames of objects. For example, you can refer
  184. to ADFS objects when NFS is the current filing system.
  185. <H3>Example</H3>
  186. <P>
  187. <TT><FONT FACE="Courier">*NFS</FONT></TT> 
  188. <H3>Related commands</H3>
  189. <P>
  190. *ADFS, *Net, *RAM, *ResourceFS, *SCSI
  191. <HR>
  192. <H2>*NFS<A NAME="Info">Info</A></H2>
  193. <HR>
  194. <P>
  195. Displays NFS module internal statistics
  196. <H3>Syntax</H3>
  197. <P>
  198. <TT><FONT FACE="Courier">*NFSInfo</FONT></TT> 
  199. <H3>Use</H3>
  200. <P>
  201. *NFSInfo displays detailed information about NFS module activity,
  202. including known hosts, users, URDs, CSDs, PSDs and Libraries,
  203. and details of its cache performance.
  204. <P>
  205. Most of the information displayed is runic in nature. It is presented
  206. mainly as an aid to trouble-shooting, should you require it.
  207. <H3>Example</H3>
  208. <P>
  209. <TT><B><FONT /TT>  FACE="Courier">*NFSInfo</FONT></B></TT> 
  210. <P>
  211. <TT><FONT FACE="Courier">Host list:<BR>
  212. name=<tp1>, usage = 1<BR>
  213. name=<tp2>, usage = 1<BR>
  214. name=<tp3>, usage = 2<BR>
  215. <BR>
  216. Cache hits 90051; Cache misses 36385 <BR>
  217. <BR>
  218. User list:<BR>
  219. name=<mhardy>, uid=<1234>, gid=<27>, usage =
  220. 1<BR>
  221. name=<nobody>, uid=<32767>, gid=<9999>, usage
  222. = 1<BR>
  223. CSD: 0x1844144, <><BR>
  224. PSD: 0x1844144, <><BR>
  225. URD: 0x1844144, <><BR>
  226. Library: 0x1844144, <></FONT></TT> 
  227. <H3>Related commands</H3>
  228. <P>
  229. None
  230. <HR>
  231. <H2>*<A NAME="time">Time</A>Offset</H2>
  232. <HR>
  233. <P>
  234. Sets the time offset in minutes from GMT to local time
  235. <H3>Syntax</H3>
  236. <P>
  237. <TT><FONT FACE="Courier">*TimeOffset <I>minutes</I></FONT></TT> 
  238. <H3>Parameters </H3>
  239. <P>
  240. <TABLE >
  241. <TR><TD WIDTH=113><TT><I><FONT /TT>  FACE="Courier">minutes</FONT></I></TT> 
  242. </TD><TD WIDTH=455>minutes offset from GMT to local time</TD>
  243. </TR>
  244. </TABLE>
  245. <H3>Use</H3>
  246. <P>
  247. *TimeOffset sets the time offset in minutes from GMT to local
  248. time. RISC OS NFS adds this offset when it interprets the server's
  249. date stamps, which it assumes to be in GMT. The offset can be
  250. negative or positive.
  251. <H3>Example</H3>
  252. <P>
  253. <TT><I><FONT /TT>  FACE="Courier">*TimeOffset 60</FONT></I></TT> 
  254. <H3>Related commands</H3>
  255. <P>
  256. None<BR>
  257. <P>
  258. <A HREF="7_AppxA" ><IMG SRC="pics/PREV.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
  259. <A HREF="Front" ><IMG SRC="pics/FRONT.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
  260. <A HREF="TOC" ><IMG SRC="pics/CONTS.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
  261. <A HREF="index" ><IMG SRC="pics/INDEX.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
  262. <A HREF="9_AppxC" ><IMG SRC="pics/NEXT.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
  263. <P>
  264. </BODY>
  265. </HTML>
  266.